DMP Electronics INC. Build Windows Embedded CE 6.0 Headless Image 


Building Windows Embedded CE 6.0 Headless Image 
2009-06-06 
This document will show developers to build Windows CE headless image for Vortex86SX/DX devices without 
display. Programmers can make native programs or console .NET application to run on headless devices. We 


assume you have Windows CE O/S customize experience to create new O/S design. 


Build Environment 
Please visit http://www.dmp.com.tw/tech/vortex86dx to download Vortex86DX BSP and install. Read BSP note 


(ftp://download@ftp.dmp.com.tw/vortex86dx/Vortex86DX 60A BSP 090324 Note.pdf) to install QFE to fix known 
bugs in Windows CE. 


Also read document at ftp://download@ftp.dmp.com.tw/vortex86dx/WinCE Development Note.pdf for some 


development note. 


Create a Headless Workspace 


Use “VDX_Headless” as project name. 


| 
few ETI 


Project types: Templates: 


=): Visual C++ Visual Studio installed templates 
ATL @ OS Design 
CLR 


General : 
“an MEC _jd Search Online Templates... 


My Templates 


» Smart Device 
Win32 
#)- Other Languages 
i#)- Other Project Types 
Platform Builder for CE 6.0 


A project for creating a Windows Embedded CE 6.0 operating system 


Name: VDX_Headless 
Location: Ne\ 
Solution Name: VDX_Headless \¥) Create directory for solution 


(|Add to Source Control 
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Start new O/S design with Vortex86DX BSP: 


“Windows Embedded 


| Board Support Packages 


Available BSPs: 
CEPC: x86 


Thin Client:X86 


x 6D0A 2009-03 


6.0 OS Design Wizard 


A BSP contains a set of device drivers 
that are added to your OS design. 


Select one or more BSPs for your OS 
design. 


BSP for DMP Vortex86DX SoC 


Note: Only BSPs supported by 


installed CPUs are displayed in the list. 


Select template “Custom Device” and press finish button to complete wizard. All necessary components will be added 


manually later. 


GB 


“Windows Embedded 
| Design Templates 


Available design templates: 


Consumer Media Device 


Industrial Device 

PDA Device 

Phone Device 

Small Footprint Device 
Thin Client 


E 6.0 OS Design Wizard 


A design template is a set of 
predefined catalog items. 


Choose the design template 
that is most closely aligned 
with the purpose of your 
target device. 


Provides the starting point for 
an OS design with no Catalog 
items selected. Possible 
devices range from simple 
network devices with no 
display to full-featured 
appliances with graphical 
displays, Internet browsing, 
and rich multimedia 
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Add Necessary Components 


Here are network components used by our demo: 

@ = Third Party -> BSP-> Vortex86Dx_60A -> RAM Size -> 256MB RAM 

@ = Third Party -> BSP-> Vortex86Dx_60A -> R6040 Ethernet Driver 

@ Core OS -> CEBASE -> Networking - Local Area Network (LAN) -> Wired Local Area Network (802.3, 
802.5). 
Core OS -> CEBASE -> Networking - General -> Windows Networking API/Redirector (SMB/CIFS) 
Core OS -> CEBASE -> Communication Services and Networking -> Servers -> FTP server 

@ Core OS -> CEBASE -> Communication Services and Networking -> Servers -> Telnet server 


For .Net headless application, add this component: 
@ Core OS -> CEBASE -> Applications and Services Development -> .NET Compact Framework 3.5 
-> .NET Compact Framework 3.5 - Headless 


If you need USB mass storage and IDE DOM support, add those: 
@ Core OS -> CEBASE -> Core OS Services -> USB Host Support -> USB Storage Class Driver 
@ Device Drivers -> Storage Devices -> ATAPI PCI Support 


Add Registry Settings 


Here are registry settings to use static IP address and enable FTP/Telnet server. Add them onto project.reg: 


3 Static IP address settings 

[HKEY_ LOCAL _MACHINE\Comm\PCI\R60401\Parms\TcpIp ] 
"EnableDHCP"=dword:@ 
"DefaultGateway"=multi_sz:"192.168.0.1" 
"UseZeroBroadcast"=dword:@ 
"IpAddress"=multi_sz:"192.168.0.232" 
"Subnetmask"=multi_sz:"255.255.255.0" 


Telnet server enable 

i HKEY_ LOCAL _MACHINE\COMM\TELNETD ] 
"IsEnabled"=dword:1 
"UseAuthentication"=dword:@ 


3 FTP server endable 

[HKEY_LOCAL_MACHINE\COMM\FTPD] 
"IsEnabled"=dword:1 
"UseAuthentication"=dword:@ 
"UserList"="@*;" 
"AllowAnonymous"=dword:1 
"AllowAnonymousUpload"=dword:1 
"AllowAnonymousVroots"=dword:1 
"DefaultDir"="\\" 


In FTPD registry, we enable anonymous login and the default root path is the whole file system on Windows CE 
device. For more information about registry settings, please search “FTP server” or “TELNET” in help of Platform 
Builder. 


DHCP is enabled by default for all Windows CE projects in Vortex86DX BSP. Because there is no display on our 
Windows CE device, it needs some operations to get IP address of CE device. So, we set fixed IP address in this 
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demo. For most real applications, fixed IP address is used. Add those registry settings into project to disable DHCP 
and use fixed IP address. The TCP/IP settings in registry are for your reference. Change them according your 


network environment. 


Run Program Automatically 


Programmers can make native C program or .Net application running on headless Windows CE image. We are 
using .Net application in this demo. This .Net demo program will send data to serial port 1000 times. Put .Net demo 
program “VDX_Headless_Net_Demo.exe” to “\VDX_Headless\Wince600\Vortex86DX_60A_x86\ OAK\files” and 


add those registry settings to run it at boot up: (Search "HKEY_LOCAL_MACHINE\init" in help for more detail) 


[HKEY_LOCAL_MACHINE\ init] 
"Launch4@"="VDX_Headless_Net_Demo.exe" 
"Depend46"=hex:14, 00 


Modify project.bib to add this line for Platform Builder to include demo program into Windows CE image: 


> Name Path Memory Type 


Build Release Image 


Developers can build debug image with KITL function to boot CE image via eboot.bin for system debug. After debug 
is done, build release image to boot from USB pen drive or DOM. Read “Windows CE Development Note” at 


ftp://download@ftp.dmp.com.tw/vortex86dx/WinCE Development Note.pdf for more detail. 


To make release Windows CE image, select “VS2005 -> Build -> Configuration Manager” to enable release mode: 


fz 
Configuration Manager 
r is 


| Active solution configuration: Active solution platform: 
Vortex86DX_60A (2009-03-24) Release ’ | | Platform Builder (_TGTCPU) 


Project contexts (check the project configurations to build or deploy): 
Project Configuration Platform Build 
VDX_Headless Vortex86DX_60A (20... | ¥| Platform Builder (_TGTCPU) w 
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Select “VS2005 -> Project -> VSX_Headless Properties “ to select release image as picture: 


"DX Headless Prope 


} 


Configuration: | Active(Vortex86DX_60A (200! ¥| Elatform: N/A ~ | Configuration Manager... 


= Common Properties Release directory: 
Build Tree (WINCEROOT)| %PBWORKSPACEROOT#RelDir\Vortex86DX_60A_x86_Debug = 
a Configuration Properties Build type: 

~~ General 

~~ Locale 

'~ Build Options 

-» Environment 

~~ Custom Build Actions 

»~ Subproject Image Setting 


(> Debug © i 
Target file name for debugger: 
nk. bin 


Configuration: | Active(Vortex86DX_60A (200! ¥| Elatform: |N/A ~ | Configuration Manager... 


5). Common Properties Build options: 
Build Tree (WINCEROOT))| [1 acked events in RAM (MGOSC 
|. Configuration Properties | Enable eboot space in memory (MGEBOOT=1) 

: Soncasl ©] Enable event tracking during boot (MGCELOGENABLE=1) 

Locale | Enable hardware-assisted debugging support IMGHDSTUB=1} 

i “Build Options jy] Enable kerel debugger (no IMGNODEBUGGER=1) 

: Enuarinoit | Enable KI TL (no IMGNOKITL=1} 

Custom Build Actions a ee 

i : : ™) Flush tracked events to release directory IMGAU TOFLUSH=1) 

~~ Subproject Image Setting) |= Run-time image can be larger than 32 MB (MGRAM64=1) 
"| Use xcopy instead of links to populate release directory (BUILDREL_USE_COPY=1) 
[) Write nm-time image to flash memory (MGFLASH=1) 


=e) 


When settings are ready, build new Windows CE image. Boot is from USB or DOM for test in next section. 


Test 


After Windows CE is loaded, our demo program will run automatically. Check serial port output to ensure demo 
program is running. 
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We use FTP client in Windows command prompt to demo. Developers can use their favorite FTP client to do files 
exchange between Windows CE device and desktop computer. The IP of Windows CE is 192.168.0.232. Use user 


name “anonymouse” and password “ftp” to login FTP server on Windows CE. Here is the FTP test screen: 
ss | —yol of] 
Administrator: S727 FIL - ftp 192.168.0232 tex 


im 


iNOftp 192.168.0.232 
onnected to 192.168.090.232. 
20 Service ready for new user. 
User (192.168.090.232: (none)): anonymous 
331 Anonymous access allowed, send identity (e-mail name) as password. 
Password: 
30 User logged in, proceed. 
ftp> Is -l 
00 Command okay. 
150 File status okay; about to open data connection. 
<DIR> Network 
<DIR> Hard Disk 
<DIR> My Documents 
<DIR> Program Files 
<DIR> Documents and Settings 
<DIR> Temp 
<DIR> Windows 
26 Closing data connection. 
347 bytes received in 0.40Seconds 0.87Kbytes/sec. 


The folder “USB Storage” is USB pen drive and “Hard Disk” is DOM on Vortex86DX board. Below picture is the 
screen using telnet to connect to Windows CE device: 


r 


GH Telnet 192.168,0.232 t= 


elcome to the Windows CE Telnet Service on WindowsCE 


Pocket CMD v 6.00 
> dir 


Directory of N 


01/01/98 :00a <DIR> Network 

01/01/98 00a <DIR> USB Storage 

01/01/98 :00a <DIR> Hard Disk 

05716709 :00a <DIR> My Documents 

05716709 00a <DIR> Program Files 

05716709 :00a <DIR> Documents and Settings 


05716709 :00a <DIR> Temp 
05/16/09 :00a <DIR> Windows 


Found 8 file(s). Total size © bytes. 
1 Dir €s) 128475136 bytes free 


Developers can run program or some jobs via telnet. Net command is used via telnet to map share folder. Run “net” 
to map share folder on desktop PC to Windows CE device: 
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N> net use test N\kenanjianNwince /user :guest 
test successfully mapped to N\kenan jian\wince 
N> cd network 
Nnetwork> dir 

Directory of Nnetwork 
05716709 test 


11:25a <DIR> 


Found 1 file(s). Total size 0 bytes. 
1 Dir (s) O bytes free 


Nnetwork> 


faa Telnet 192.168.0,.232 —s uel x 


Folder “wince” on desktop Windows XP/Vista PC will be mapped to “test” folder in “Network” folder of Windows CE 


root file system. Just change work directory to “Network” and run dir command, you can find test folder. If full access 


right is enabled, Windows CE device can read or write files in folder test. 


[e] 
— 
[v) 


| 


As our test, only domain name “kenanjian” can work and IP address “ 
using domain when you test SMB function. 


example to share hard disk for your reference: 
[HKEY_LOCAL_MACHINE\Services\Smbserver ] 
"AdapterList"="*" 
"d1l"="smbserver.d1l" 
"Keep"=dword:1 
"Order"=dword:9 


[HKEY_LOCAL_MACHINE\Services\SMBServer\Shares ] 
"UseAuthentication"=dword:@ 


[HKEY_LOCAL_MACHINE\Services\SMBServer\Shares\HDD ] 
"Path"="\\Hard Disk" 
"Type"=dword:@ 
"UserList"="@*;" 


Reference 


Visit http://www.dmp.com.tw/tech/vortex86dx for more technical resourece. 


192.168.X.X” can not work. Recommend 


Windows CE device also can be SMB server. Search help of Platform Builder to add registry settings. Here is 


Windows CE development note: ftp://download@ftp.dmp.com.tw/vortex86dx/WinCE Development _Note.pdf. 


For more technical support, please visit http://www.dmp.com.tw/tech or ma 


il to tech@dmp.com.tw. 


70f7 


